home *** CD-ROM | disk | FTP | other *** search
/ Macworld Expo - Develope…Central & Net Innovations / Developer Central and Net Innovators (MacWorld Expo) (January 1999).iso / Developer Central / Metrowerks CodeWarrior / CodeWarrior Pro 4 Release Notes / Java Notes / MWJava StandAlone Release Notes < prev    next >
Encoding:
Text File  |  1998-09-02  |  10.7 KB  |  277 lines  |  [TEXT/CWIE]
  1. ========================================================================
  2. Metrowerks Java StandAlone Release Notes 
  3. ========================================================================
  4.  
  5. Version: 1.5
  6. Date:    9-2-98
  7. Authors: Greg Bolsinga, Michael C. Stricklin, Scott Kovatch,
  8.     Marcus Jager, Tim Freehill
  9. ========================================================================
  10.  
  11. StandAlone Java is an application that hosts Java Virtual Machines on 
  12. the Macintosh. It supports Apple's MRJ and Metrowerks' JVM. It creates
  13. double-clickable MacOS java applications.
  14.  
  15.  
  16. ========================================================================
  17. How To Use
  18. ========================================================================
  19.  
  20. Metrowerks Java StandAlone encapsulates the JVM interface with the
  21. user's java code. The JVM will be found in the usual places:
  22.  
  23. MRJ: In the default Extensions folder installation, or next to the
  24.     StandAlone MacOS application, if the user wants to use newer 
  25.     versions of MRJ.
  26.     
  27. MW JVM: The same folder as the generated StandAlone _only_.
  28.  
  29. Use the Java MacOS Post Linker and set it to MW Standalone.
  30.  
  31. If the JVM is set to 'Metrowerks' or 'Metrowerks - JIT', the file
  32. 'Metrowerks VM' & the folders 'Classes' & 'Lib' _must_ be in the same
  33. folder as the StandAlone MacOS application. If they aren't, StandAlone
  34. will look for MRJ.
  35.  
  36. The settings in for MW Standalone control whether a Console window is
  37. made available and the behavior desired when files are dropped onto
  38. the resulting StandAlone MacOS application.
  39.  
  40. The console window won't display itself until it is needed, check or
  41. uncheck "Has Console Window" to set.
  42.  
  43. The behavior of the resulting StandAlone MacOS application in relation
  44. to files dropped onto it can also be modified. In previous versions of
  45. StandAlone, every file dropped onto the StandAlone MacOS application
  46. would create a new JVM instance with the filename as an argument added
  47. to the end of the list. Now there are four options:
  48.  
  49. 1. No dropped files allowed. No files dropped onto the StandAlone MacOS
  50.    application will ever be added to the java application's argument
  51.    list. It can be started up by a dropped file, but the file is
  52.    ignored. All subsequent dropped files are ignored. This only allows
  53.    one instance of the JVM to be created during the StandAlone MacOS
  54.    application's lifetime.
  55.    
  56. 2. First dropped file only. Only the first file dropped onto the
  57.    StandAlone MacOS application will be added to the command line
  58.    arguments for the java application. If the StandAlone MacOS
  59.    application is started up without a file dropped upon it, it will
  60.    ignore any more dropped files. This only allows one instance of the
  61.    JVM to be created during the StandAlone MacOS application's lifetime.
  62.  
  63. 3. Multiple files can be dropped, one JVM. All files dropped onto the
  64.    StandAlone MacOS application will be added added the command line
  65.    arguments for a new java application instance. This allows only one
  66.    instance of the JVM to exist at one time during the StandAlone MacOS
  67.    application's lifetime. It will kill the current instance of the JVM
  68.    whenever a new file is dropped on the StandAlone MacOS application.
  69.    
  70. 4. Multiple files can be dropped, many JVMs. All files dropped onto the
  71.    StandAlone MacOS application will be added added the command line
  72.    arguments for a new java application instance. This allows many
  73.    instances of the JVM to exist at one time during the StandAlone MacOS
  74.    application's lifetime. This was the previous behavior of the 
  75.    StandAlone MacOS application.
  76.  
  77.  
  78. ========================================================================
  79. Released Versions
  80. ========================================================================
  81.  
  82. 1.5                            CWPro4
  83. 1.2                            CWPro3
  84. '10-21-97'                    CWPro2
  85.  
  86.  
  87. ========================================================================
  88. New Features since CWPro3
  89. ========================================================================
  90.  
  91. * MW Standalone now builds without stationery and editing MacOS
  92.   resources. It's options are settable in the Java MacOS Post Linker.
  93.   
  94. * Apple MRJ 2.0 is now better supported, since StandAlone Java now uses
  95.   JManager 2.0. (For example: windows won't be shoved in the corner,
  96.   moving windows works, zooming windows works. Command line args are
  97.   used.)
  98.   
  99. * The StandAlone Java w/ Embedded JVM has been dropped. This only
  100.   supported a special build of the MV JVM, which isn't the default JVM
  101.   anymore.
  102.   
  103. * The MacOS version number of the JVMs used by StandAlone Java is shown
  104.   in the about box. This makes support easier for StandAlone Java.
  105.   
  106.       
  107. ========================================================================
  108. Bugs Fixed since CWPro3
  109. ========================================================================
  110.  
  111. * Fix a bug that would draw windows incorrectly once they were moved or
  112.   resized. (partial MW09157)
  113.   
  114. * Fix a little leak when running applications. (Since 1.5b7)
  115.  
  116. 1.5b7:
  117.  
  118. * Fix a bug when searching for the MRJ Code Fragment. It now uses CFM
  119.   always. Clean up some MRJ callbacks.
  120.  
  121. * Fix a bug that would manifest itself in crashes when running Swing
  122.   when a JMenu that was taller than its JFrame would be shown & crash
  123.   when its hidden. (Since 1.5b1) (Part of MW08510)
  124.  
  125. * Fix a bug where MRJ wasn't told that a java window had been moved by
  126.   the user. This would be especially obvious when using Swing menus.
  127.   (since 1.5b1) (Part of MW08510)
  128.  
  129. * Clean up the MRJ JManager 2.0 JNI code again. Thanks to Pedro Larios.
  130.   (Since 1.5b6) (MW08640)
  131.   
  132. * The console window won't always come to the front when text is written
  133.   to it. It also won't show up for the first time in front of a java
  134.   virtual machine window.
  135.  
  136. 1.5b6:
  137.  
  138. * Fix memory leak when running java applications with MRJ. A JNI global
  139.   reference to the main() arguments was being 'lost'. (Since 1.5b1)
  140.  
  141. 1.5b5:
  142.  
  143. * Fix bug where the cursor wasn't always at the end of the text in the
  144.   console window. (Since 1.5b4)
  145.   
  146. 1.5b4:
  147.  
  148. * The console window now uses the WASTE text engine. This means it can
  149.   hold more text. The console window now also draws more clearly.
  150.  
  151. * System.in works from the MW Java Console window now if MRJ 2.1 or the
  152.   MW JVM is being used. See below for a note about MRJ 2.0.
  153.  
  154. * Fix a bug with MRJ StandAlone. System.exit() wouldn't quit the
  155.   StandAlone MacOS application.
  156.   
  157. 1.5b3:
  158.  
  159. * Fix a bug in regulating the behavior of files dropped onto the 
  160.   StandAlone MacOS application. It now does exactly what it says it will
  161.   do in the How To section.
  162.  
  163. 1.5b2:
  164.  
  165. * The working directory is always set to the directory that the
  166.   StandAlone MacOS application is in.
  167.   
  168. * The JVM now only loads once it's needed! Also the JVM loading code is
  169.   smarter, so MW Java won't idle & do nothing when a JVM wanted is
  170.   missing. (since 1.2.1) (MW07139)
  171.   
  172. * Fix a sometimes crasher when attempting to display the 'Loading
  173.   JVM...' dialog box.
  174.   
  175. 1.5b1:
  176.  
  177. * There's now a way to specify what should occur when a file is dropped
  178.   onto the resulting StandAlone MacOS application. See 'How To Use'
  179.   above for information.
  180.   
  181. * Editing of the 'MW Java StandAlone.lib' isn't necessary to change the
  182.   behavior for a given project. See 'How To Use' above for information.
  183.   (Obsolete w/ Java MacOS Post Linker)
  184.   
  185. * The Finder icon has been fixed. There was a problem w/ the BNDL
  186.   resource. (since 1.2)
  187.   
  188. * Removed Mercutio code & resources since it was unused.
  189.  
  190. * Fix the password field in the Authentication Dialog box. (since 1.2)
  191.   
  192. * Greatly reduced the executable size. (since 1.2)
  193.  
  194. * If the Metrowerks JVM wasn't in the same folder as StandAlone Java,
  195.   CFM would look in the System folder, and MS JVM would be identified as
  196.   MW JVM, due to MS JVM's & MW JVM's common ancestry. StandAlone Java 
  197.   will now _absolutely_ look for MW JVM in the same folder as itself.
  198.   (since 1.2)
  199.  
  200. * The zoom button for MW JVM windows now does something. (since 1.2)
  201.  
  202. * Arguments are now passed to MRJ without crashing the JVM. (MW05872,
  203.   MW05900)
  204.   
  205. * MRJ is now found using CFM routines. This way different versions of
  206.   MRJ can be used & tested. CFM attempts to find dll's in the same 
  207.   directory as the executable first, then looks in the System folder.
  208.   (since 1.2)
  209.   
  210. * Passes key release events to MRJ (but not to MW JVM). (since 1.2)
  211.  
  212. * Fully qualified main class names are acceptable if '.' delimited or
  213.   '/' delimited.
  214.   
  215. * Fixed bug where the working directory setting wasn't being passed to
  216.   MRJ.
  217.   
  218. * Fixed modal dialogs with MRJ 2.0 in StandAlone Java.
  219.  
  220.   
  221. ========================================================================
  222. Known Bugs and Incompatibilities
  223. ========================================================================
  224.   
  225. * MRJ 2.0 & MRJ 2.1ea1 have some problems when quitting MW Java in rare
  226.   circumstances, but it is fixed in MRJ 2.1ea2. (Part of MW08510)
  227.  
  228. * Right now, System.in doesn't work with MW Java's Console window if the
  229.   JVM selected is MRJ 2.0. Hopefully this will be fixed soon. Please run
  230.   com.mw.SystemInput before any java application that requires System.in
  231.   when using MRJ 2.0. It is present in the classes.zip used by the MW
  232.   JVM. MW JVM's classes.zip could be added to the class path so
  233.   SystemInput could be found. Or you can take it out of MW JVM's
  234.   classes.zip with Class Wrangler. Or, you could compile it into your
  235.   output. MRJ 2.1 fixes this problem.
  236.  
  237. * Either MRJ or the Metrowerks JVM may crash StandAlone Java if their
  238.   respective class libraries are not found in their proper places.
  239.  
  240.  
  241. ========================================================================
  242. Additional Notes
  243. ========================================================================
  244.  
  245. *  To use this version of StandAlone Java, the files Metrowerks Java
  246.    JVM, and the Classes and Lib folder must reside in the same folder as 
  247.    StandAlone Java. Or MRJ must be properly installed. If you'd like to
  248.    use a newer version of MRJ & keep around an old one, place an alias
  249.    to "MRJLib" next to StandAlone Java. It will find and load the MRJ in
  250.    the application's folder before any installed in the Extensions
  251.    folder.
  252.  
  253. *  The new .cab support in the MW appletviewer (only in the MW JVM) now
  254.    creates a folder called "Retrieved Files" in the same folder as the
  255.    application. This folder is used to store temporary files for the cab
  256.    decompression engine.
  257.  
  258.  
  259. ========================================================================
  260. Contacting Metrowerks
  261. ========================================================================
  262.  
  263. For bug reports, technical questions, and suggestions, please use the
  264. forms in the Release Notes folder on the CD, and send them to
  265.  
  266. support@metrowerks.com
  267.  
  268. See the CodeWarrior on the Nets document in the Release Notes folder for
  269. more contact information, including a list of Internet newsgroups, 
  270. online services, and patch and update sites.
  271.  
  272.  
  273. ========================================================================
  274.  
  275. Greg Bolsinga
  276. Metrowerks Corporation
  277.